home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / gt_power / dproc102.zip / DIZPROC.DOC next >
Text File  |  1993-03-28  |  10KB  |  182 lines
  1.  ┌─────────────────────────────────────────────────────────────────┐
  2.  │    DizProcessor  Version 1.02    Bob Butcher   GTPN 050/059     │
  3.  └─────────────────────────────────────────────────────────────────┘
  4.  
  5.              DizProc is Copyright (c) Bob Butcher 1993
  6.                         All Rights Reserved.
  7.  
  8.                        GT Power Copyright of
  9.                       P & M Software Company,
  10.                        3104 E. Camelback Rd.
  11.                       #503 Phoenix, AZ  85016
  12.                                U.S.A
  13.  
  14.                  ARCE    is Copyright of Vernon D. Buerg.
  15.                  ARJ     is Copyright of Robert K. Jung.
  16.                  LHA     is Copyright of Haruyasu Yoshizaki.
  17.                  PAK     is Copyright of NoGate Consulting
  18.                  PKUNZIP is Copyright of PKWare Inc.
  19.  
  20.  ┌─────────────────────────────────────────────────────────────────┐
  21.  │                            Disclaimer                           │
  22.  └─────────────────────────────────────────────────────────────────┘
  23.   DIZProc is guaranteed to take up some disk space when not in use
  24.   and to take up some memory and disk space when in use. it may or
  25.   may not release the memory it uses depending on how it feels at
  26.   the time it finished operating. Other than that you are on your
  27.   own, I will not accept any responsibility for anything it may do
  28.   to your hardware, software, financial or mental well being. It
  29.   works here, most of the time <grin>.
  30.  
  31.  ┌─────────────────────────────────────────────────────────────────┐
  32.  │                             Money                               │
  33.  └─────────────────────────────────────────────────────────────────┘
  34.   Strictly speaking it's FREE, OK calm down I know that's the sort
  35.   of price we all like paying for software <grin>.
  36.  
  37.   I don't ask for money for Dizproc neither does it send any
  38.   messages to anyone, but if you like it and wish to make some
  39.   contribution then send a few pounds/dollars/yen (or whatever) to
  40.   the following address.
  41.  
  42.                           MAKE A KID SMILE
  43.                          c/o Ernest Debakey
  44.                    The Bechtel Tower, Suite 1480
  45.                       3000 Post Oak Boulevard
  46.                        Houston, TX 77056-6582
  47.                                U.S.A.
  48.  
  49.  ┌───────────────────────────────────────────────────────────────────┐
  50.  │                            Purpose                                │
  51.  └───────────────────────────────────────────────────────────────────┘
  52.  
  53.   DizProc is designed to build a GT FILES.BBS entry for a file from
  54.   a description held in a DIZ file. It works by checking the files
  55.   in the directory against those listed in the FILES.BBS. If a file
  56.   is not listed DizProc will check the relevant archive for either a
  57.   FILE_ID.DIZ or an file using the old SmartFA naming convention.
  58.  
  59.   If neither file exists in the archive DizProc will add a standard
  60.   line with the following info:
  61.  
  62.   File Name File Size File Date System Date
  63.  
  64.   To use DizProc just point it at the directory you want it to check
  65.   by specifying the path on the command line:
  66.  
  67.   i.e.
  68.  
  69.                          DizProc D:\HOTWARE
  70.  
  71.   Would check my HOTWare directory, if no directory is given DIZProc
  72.   will check the current directory.
  73.  
  74.  ┌───────────────────────────────────────────────────────────────────┐
  75.  │                       Configuration File                          │
  76.  └───────────────────────────────────────────────────────────────────┘
  77.  
  78.  The configuration file and all of it's components are completely
  79.  optional, If you don't want it you don't have to use it.
  80.  
  81.  First the musts. The config file must be called DIZPROC.CNF and it
  82.  must reside in your GTPATH directory. Comments must be on separate
  83.  lines.
  84.  
  85.  Now the optionals. The configuration file currently supports the
  86.  following options:
  87.  
  88. ┌──────────┬─────────────────────────────────────────────────────────┐
  89. │ Option   │ Description                                             │
  90. ├──────────┼─────────────────────────────────────────────────────────┤
  91. │ LINE=    │ This allows you to choose between six line formats.     │
  92. │          │ They are:                                               │
  93. │          │                                                         │
  94. │          │ DEFAULT 1  File Name  File Size  System Date  File Date │
  95. │          │         2  File Name                                    │
  96. │          │         3  File Name  File Size                         │
  97. │          │         4  File Name  File Size  System Date            │
  98. │          │         5  File Name  File Size  File Date              │
  99. │          │         6  File Name  File Size  File Date  System Date │
  100. │          │                                                         │
  101. │          │ The default is 1, if nothing is specified this format   │
  102. │          │ is used. To use a different option the line would be:   │
  103. │          │                                                         │
  104. │          │ LINE=3                                                  │
  105. │          │                                                         │
  106. │          │ Please note that there must be no spaces between the    │
  107. │          │ = sign and the option.                                  │
  108. │          │                                                         │
  109. ├──────────┼─────────────────────────────────────────────────────────┤
  110. │ INDENT=  │ The number of spaces the description is indented from   │
  111. │          │ the left margin before the |.                           │
  112. │          │                                                         │
  113. │          │ For example:                                            │
  114. │          │                                                         │
  115. │          │ INDENT=12                                               │
  116. │          │                                                         │
  117. │          │ would give something like this:                         │
  118. │          │                                                         │
  119. │          │ DPROC101.ARJ   17,706  03/28/93  03/22/93               │
  120. │          │             | DIZProcessor v1.01 from Bob Butcher       │
  121. │          │             | 050/059 - scans a directory and builds a  │
  122. │          │             | GT Power FILES.BBS entry from an          │
  123. │          │             | enclosed FILE_ID.DIZ or SmartFA format    │
  124. │          │             | DIZ file. Now supports ARC, ARJ, LHZ,     │
  125. │          │             | PAK and ZIP format files.                 │
  126. ├──────────┼─────────────────────────────────────────────────────────┤
  127. │ COMMA=   │ This is a TRUE or FALSE Flag. If set to true the file   │
  128. │          │ size will be printed like this:                         │
  129. │          │                                                         │
  130. │          │ DPROC101.ARJ   17,706  03/28/93  03/22/93               │
  131. │          │                                                         │
  132. │          │ Otherwise it will written like this:                    │
  133. │          │                                                         │
  134. │          │ DPROC101.ARJ    17706  03/28/93  03/22/93               │
  135. ├──────────┼─────────────────────────────────────────────────────────┤
  136. │ SPECIAL= │ OK this is for those of you who want to add the         │
  137. │          │ Download Counter [] to the file description.            │
  138. │          │                                                         │
  139. │          │ It is used like this:                                   │
  140. │          │                                                         │
  141. │          │ SPECIAL=[0]                                             │
  142. │          │                                                         │
  143. │          │ This would add [0] to the first line of the file        │
  144. │          │ description, the result would look something like:      │
  145. │          │                                                         │
  146. │          │ DPROC101.ARJ   17,706  03/28/93  03/22/93               │
  147. │          │             | [0] DIZProcessor v1.01 from Bob Butcher   │
  148. │          │             | 050/059 - scans a directory and builds a  │
  149. │          │             | GT Power FILES.BBS entry from an          │
  150. │          │             | enclosed FILE_ID.DIZ or SmartFA format    │
  151. │          │             | DIZ file. Now supports ARC, ARJ, LHZ,     │
  152. │          │             | PAK and ZIP format files.                 │
  153. └──────────┴─────────────────────────────────────────────────────────┘
  154.  
  155.  
  156.  ┌───────────────────────────────────────────────────────────────────┐
  157.  │                              History                              │
  158.  └───────────────────────────────────────────────────────────────────┘
  159.  
  160.   1.00  Initial release.
  161.   1.01  Bug fix for file size. (RW)
  162.         Bug fix for file date system date (they were in the wrong
  163.         order. (RW)
  164.         If the FILES.BBS does not exist in the directory DIZProc is
  165.         checking one will be created. (ED)
  166.         Added support for archive types other than ARJ and ZIP.
  167.         They are:
  168.         ARCE 4.0g Copyright Vernon D. Buerg. for .ARC files
  169.         LHA  2.13 Copyright Haruyasu Yoshizaki for .LZH files.
  170.         Pak  2.50 Copyright NoGate Consulting for .PAK and .SDN files.
  171.   1.02  Will default to checking the current directory if no command
  172.         line argument is supplied.
  173.         Line format for FILES.BBS can now be in one of six formats.
  174.         File sizes are now optionally comma delimited.
  175.         Indentation is now configurable.
  176.         Option for adding special entry into file description.
  177.  
  178.   That's it for now, have fun.
  179.  
  180.   later chap   -   bob
  181.  
  182.